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ABSTRACT 



The present invention discloses a method, apparatus, and 
article of manufacture for distributing a software application 
residing on a network, from a source computer coupled to 
the network, to a remote computer via electronic mail. 

At the source computer, the present invention identifies the 
software installation components that reside on the source 
computer. These software installation components are used 
to install the software application. The identified software 
installation components are compared to the remote com- 
puter's software installation components. This comparison 
determines which software installation components are 
missing from the remote computer. To provide the files 
required for installation of the software application, the 
present invention transfers the missing software installation 
components from the source computer to the remote com- 
puter. 
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<$lg.3<£) 



Subject: 

*" MobileONE Requesting Files - MBA 2.0 



334 



Text: 

This message is a request by MobileONE for additional files - 
to be sent in order to enforce the package specified: 



336 



-message-type: AckFile Request 

package-reference: {DCA45564-45A6-11D1-B026-444553540000} - 
status: Despooled into C:\Program FilesNMobileONE MnWork successful - 
-orig-machine: DOUGREMOTE 

Orig-date-locaMime: Thursday, October 16, 1997 10:05:04- 
Orig-date-gmt-time: Thursday, October 16, 1997 14:05:04 - 

- package-name: snapshot.pkg 
-orig-message-type: Normal 

node-id: {340D5901 -45A7-1 1 D1 -B026-444653540000} - 
master-job-id: {99B94A90-45A6-1 1D1-B026-444553540000}- 

- request-files-total: 3 

- file 1 : mmsystem.dll 
-file2: odbctrac.dll 

- file3: dplay.dll 



-340 



-342 



-354 
— 356 
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METHOD FOR DISTRIBUTING SOFTWARE FIGS. 2A-2F are flowcharts that illustrate the logic per- 

OVER NETWORK LINKS VIA ELECTRONIC formed according to the present invention; and 

MAIL FIGS. 3A-3D illustrate exemplary file formats of a snap- 



BACKGROUND OF THE INVENTION 



shot file created according to the present invention. 



Overview 



1. Field of the Invention DETAILED DESCRIPTION OF THE 

™ . . , t n t . PREFERRED EMBODIMENT 
This invention relates generally to managing computers 

systems in a distributed network, and more specifically, to a [ Q the following description of the preferred 

method for distributing software over slow network links via jq embodiments, reference is made to the accompanying draw- 

electronic mail. ings which form a part hereof, and in which is shown by way 

2. Description of Related Art of illustration a specific embodiment in which the invention 
Many companies issue laptops, notebooks, and hand-held may be practiced. It is to be understood that other embodi- 

computers to their employees. These computers allow the ments mav be utilized and structural changes may be made 
employee to work both at the office and away from the oflce 1S without departing from the scope of the present invention, 
at remote locations. As a result, remote computers currently 
represent three out of every ten personal computers (PCs) in 
Corporate America. This number may increase to almost jh e p resen t invention provides a unique and efficient 
seven out of ten by the end of 1999. method for distributing software to remote clients via 
Although remote computers provide flexibility, they are 20 e-mail. E-mail is a very efficient communication mechanism 
difficult to support when they arc not connected to a local and typically, it is already installed in existing corporate 
area network (LAN) based system. For example, typical infrastructures. The present invention utilizes these existing 
methods of updating and supporting these devices involve, infrastructures to perform tasks that usually require a high- 
packaging up the devices and sending them back to a central speed LAN connection. 

office for new software packages and configuration changes 25 Another objective of the present invention is maintaining 
or waiting until the devices are brought in from the field and required software installations and configurations for corn- 
left with system administrators for a couple of days. These putcrs ^at arc not permanently connected to a corporate 
methods create a significant amount of downtime and loss of netW ork and/or computers that use dial-up networking or 
productivity for businesses. c . mail as thc j r mam communication mechanism, 

A solution to the problem involves providing access to 30 A embodiment of ^ present i nven tion is to 
software updates over a dial up link for remote users. Yet, the reduce network traffic . u nlike other software distribution 
resources used to create such access are lacking in most system s, the present invention does not assume the state of 
LAN based systems. ^ e remo t e computer. Instead, the present invention deter- 
As more remote devices become part of the standard mines the state of the remote computer before distributing 
corporate computing power, a clear need is emerging for a 35 software installation components to the remote computers, 
solution that allows remote users to connect to a LAN Determining the state increases the probability of distribut- 
without bringing their computers in from the field. ing only the required installation components and reduces 

network traffic. In the present invention, the installation 
components comprise both software installation files and 
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40 

To overcome other limitations that will become apparent configurations settings, 
upon reading and understanding the present specification, 

the present invention discloses a method, apparatus, and Hardware Environment 
article of manufacture for distributing a software application FIG x schcmatica u y illustrates the hardware environment 
residing on a network, from a source computer coupled to ^ of ^ preferred embodinl ent of the present invention, and 
the network, to a remote computer that is not coupled to the mofC particularlv> illustrates an exemplary distributed corn- 
network. p Uter S y Stem 100. A typical combination of resources may 
At the source computer, the present invention identifies include target computers 102 that are personal computers or 
the software installation components. These software instal- workstations, and source computers 104, that are personal 
lation components are used to install the software applica- 5Q computers, workstations, servers, minicomputers, or main- 
tion. The identified software installation components are frames. These systems are coupled to one another by various 
compared to the remote computer's software installation networks 106, including LANs, WANs, SNA networks, and 
components. This comparison determines which software tne internet. The target computers 102 are coupled with the 
installation components are missing from the remote com- source computers 104 over a line or via a wireless system, 
puter. To provide the files required for installation of the 5$ such mat ^ data flows from ^ c sourcc computer 104 to the 
software application, the present invention transfers the target computer 102. 

missing software installation components from the source Remot£ ^ compulers 108 m also wilh the 

computer to the remote computer. S0UfCC computcrs m , In mc prc f crrc d embodiment of the 

In an alternative embodiment of the present invention, the present invention, the remote computers 108 may be per- 

invention requests the missing software installation compo- 60 sona i com puters, workstations, laptops, notebooks, and/or 

nents from the source computers. hand-held devices. The remote computers 108 and source 

BRIEF DESCRIPTION OF THE DRAWINGS ni" *?a ^T^i \° T^T^ ^ 7"*°™ 

networks 106, including the Internet 110. The remote corn- 
Referring now to the drawings in which like reference puters 108 are coupled with the source computers 104 over 
numbers represent corresponding parts throughout: 65 a line or via a wireless system, such that all data flows from 
FIG. 1 illustrates an exemplary hardware environment the source computer 104 to the remote computer 108. 
that could be used with the present invention; However, in the preferred embodiment of the present 



03/08/2004, EAST Version: 1.4.1 



US 6, IS 

3 

invention, the remote computers 108 and the source com- 
puters 104 are not coupled via a shared network 106. 

Those skilled in the art will recognize that many modi- 
fications may be made to this configuration without depart- 
ing from the scope of the present invention. Indeed, those 
skilled in the art will recognize that other alternative hard- 
ware environments may be used without departing from the 
scope of the present invention. 

Flowcharts 

FIGS. 2A-2F are flowcharts that illustrate the logic per- 
formed according to the present invention. FIG. 2A is 
high-level overview of the preferred embodiment of the 
invention. 

Block 200 represents the source computer 104 creating a 
snapshot of some or all of the software installation compo- 
nents on a source computer 104. The software installation 
components comprise the software files and configuration 
settings that are required for installing the software appli- 
cation to be distributed. A snapshot may be a graphical 
representation, a textual list or any equivalent means for 
identifying the required software installation components. 

Block 202 is a decision block that represents the preferred 
invention determining whether file images are present in the 
snapshot. Snapshots may include several components, other 
than file images. For example, they frequently include 
registry settings, configuration files, etc. If file images are 
included in the snapshot, then the present invention proceeds 
to Block 204. Otherwise, if file images are absent from the 
snapshot, the present invention proceeds to Block 208. 

Block 204 represents the present invention dividing the 
file images into several small pieces or sub-packages. These 
smaller sub-packages provide an efficient means of sending 
information to the remote user. 

Block 206 represents the present invention generating a 
snapshot description file that describes the snapshot file, 
including the file images that are stored in the sub-package. 
This description also includes instructions for installing the 
distributed software application. 

Block 208 represents the present invention sending the 
snapshot description file to the remote computer 108 via 
e-mail. The sub-packages are kept at the source computer 
104. 

Block 210 represents the present invention directing the 
remote computer 108 to process incoming e-mail messages. 
The processing involves automatically scanning the incom- 
ing e-mail messages, and identifying messages that contain 
the snapshot description file. Once the messages are 
identified, the remote computer 108 compares the snapshot 
description file to the remote computer 108 's software 
installation components. This comparison determines 
whether the remote computer 108 is in compliance with the 
specifications of the snapshot. Compliance exists when the 
correct software files are in the correct locations on the 
remote computer 108; the remote computer 108's software 
files are the same or more recent version of the source 
computer 104's software files; and the configuration file 
settings are correct. If compliance between the remote 
computer 108 and the source computer 104 is lacking, the 
remote computer may request software installation compo- 
nents from the source computer 104. 

Block 212 represents the source computer 104 receiving 
a request for software installation components from the 
remote computer 108. In the preferred embodiment of the 
present invention, the request is received via e-mail. Upon 
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receiving the request, the source computer 104 retrieves the 
requested software installation components from the previ- 
ously generated sub-package files (see block 204). 
Block 214 represents the present invention sending the 

s requested software installation components as a series of 
e-mail messages from the source computer 104 to the remote 
computer 108. 

Block 216 represents the remote computer 108 receiving 
the series of e-mail messages that contain the requested 

10 software installation components and assembling them so 
that the snapshot description file can access them. The 
present invention then compares the source computer 104's 
snapshot description file to the remote computer 108's 
software installation components. Based on the comparison, 

15 the present invention brings the remote computer 108 in 
compliance with the source computer 104 by extracting 
sub-packages from the source computer 104. 

Block 218 represents the present invention storing the 
snapshot file description on the remote computer. 

20 Periodically, the invention directs the remote computer to 
compare the snapshot file description with the remote com- 
puter 108's software installation components. This periodic 
comparison determines whether the remote computer's soft- 
ware installation components have been changed. If changes 

25 exist, the remote computer 108 extracts the required soft- 
ware installation components from the sub-packages. If 
additional files are needed, they are later retrieved from the 
source computer 104. 

FIG. 2B is a detailed representation of the logic performed 

30 at the source computer 104 to create a snapshot sub-package. 
Block 220 represents the source computer 104 receiving the 
selection of software installation components from a user. 
The selection may include components from multiple source 
computer 104 directories, drives, configuration files 

35 (autoexec.bat, config.sys, ini.files, etc.) and Registry key 
entries. 

Block 222 represents the present invention beginning the 
scan process at the source computer 104. The scanning 
process may be applied to Registries, configuration files, 

40 software files, and/or directories. 

Block 224 is a decision block that represents the present 
invention determining whether to scan a Registry. If so, the 
invention proceeds to block 226. Otherwise the invention 
proceeds to block 228. 

45 Block 226 represents the present invention scanning the 
registry for sections that are required for installation of the 
software to be distributed. 

Block 228 is a decision block that represents the present 

5Q invention determining whether to scan the configuration 
files. If so, the invention proceeds to block 230. Otherwise 
the invention proceeds to block 232. 

Block 230 represents the present invention scanning the 
configuration files for configuration settings that are required 

5S for installation of the software to be distributed. 

Block 232 is a decision block that represents the present 
invention determining whether to scan the directories. If so, 
the invention proceeds to block 234. Otherwise, the inven- 
tion proceeds to block 236. 

60 Block 234 represents the present invention scanning the 
directories for software components that are required for 
installation of the software to be distributed. 

Block 236 represents the present invention compressing 
file images. Once the items have been scanned, the present 

65 invention does a special check to determine if files were 
included in the scan results. If they were, the file images are 
compressed and included as part of the snapshot package. 
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The snapshot package file itself is designed to be efficient combined to create the Normal package. Once the Normal 

in the way it stores large amounts of information. It provides packages are formed, the present invention directs the 

the present invention with the ability to easily replace remote computer 108 agent to execute the snapshot descrip- 

information that may change frequently without having to lion file. The remote computer 108 agent performs tasks at 

re-write the entire snapshot file contents (which may be 5 the remote computer 108, under the direction of the present 

several megabytes in size). invention. Executing a snapshot description file involves 

FIG. 2C is a representation of the steps performed at the scanning the remote computer for software components that 

remote computer 108 according to the present invention. correspond to the snapshot description file contents and 

Block 240 represents the remote computer 108 scanning performing a comparison against the snapshot description 

its e-maain-box for new messages. In the preferred embodi- 10 filc * * D0 filc J™®? ™ rc ^ d f * ma * e * c f . rcm ° lc 

ment of the present invention* the invention searches for computer comply with the snapshot descnption then the 

messages that contain the "MBA 2.0" tag in the subject text s ° a P shot 15 Permed again and allowed to make changes 0 

f b m • (U : n u n ^ the remote computer 108. If file images are required to 

of the e-mail messages in the m-oox. . 4 4 . r *• • . *l * 

. . . complete the software application installation, the agent 

Block 242 represents the present invention removing ^ me ^ (o ^ ^^^Am 

tagged messages from the remote computer 108 Is e-ma. 1S for ^ ire(J flles £ a resu , on] ^ M fl , es wfl , 

in-box When a message b found with the MBA 2XT bfi ^ oyer ^ from lhe ^ ^ f 104 l0 

15 ° m ^ rem ° te com P uter 108 

t,, . ...... ■ j • • l, i . L . . .l . Block 266 is a decision block that represents the present 

Block 244 is a decision block that represents the present checkin ^ next mn dat£ and ^ field for a „ 

invention determinmg .f any file attachments exist .If they w fi * s ^ exisl m ^ wofk dire , { ;( fa 

do, the file a'tachmente are saved to a work directory, as J ° n thc package> thc packagc Ls 6X6Cute d, as 

represented by block246. Otherwise, the invenUon proceeds represented by Woc £ 268 6 otherwise, control returns to 

to block 248. block 252 where the present invention continues processing 

Block 248 is a decision block that represents the present new ckages as mey arrive and keeps i aunching packages 

mvention determining if the message-type is Normal. There mat ^ to ma on a repe titive basis, 

are several possible types of messages, including Normal nG 2£ mus(rates the , ic performed by the Mnroe 

Ack, AckFileRequest. The Normal message b an e-mail [cf 1M wheQ ft £ s £ remotc „ ler 108>s 

message from thc source computer 104. It contains files to for additional ^ 

be distributed to a remote computer 108. Ack messages are 1^ . . . . 

e-mail reply messages from the remote computer 108, B1 °* 2 ™ 15 a rcpiesenUUon of the present mvention 

stating mat everymtag was received by the remote computer. 30 P roce ^J? e mcomm S e ' m f m ^g eal c ° m - 

a 1 1- • 1 r. / _ „ -i A i„ outer 104. The source computer 104 receives the request tor 

AckFileRequest messages are e-mail reply messages from , i, ^ *u * ♦ me u 

the remotTcomputer 108, stating that the snapshot descrip- additional files from the remote computer 108 by scanning 

tion file was revived but, additional file images are required the mcoming e-mad messages and looking for the messages 

' with a subject text that contams "MBA 2.0. 

to continue processing. , . , . . . A * 

Tr . kt i u ~„i~a a ;i « Block 272 is a decision block that represents the present 

If the message is Normal, an acknowledgment e-mail 35 . ■ A i rr 

message is sent from the remote computer 108 to the source mvenUon determining if the message is an Ack message. If 

computer 104. The purpose of this message is to let the so > acknowledgment message is logged in the database 

source computer know that the message was received to denote a successful transmission of a particular package 

successfully, as represented in block 250. to a particular remote computer 108 recipient, as represented 

FIG. 2D is a representation of the logic required to 40 b y block 274 ' Otherwise, proceeds to block 276. 

process the packages and sub-packages at the remote com- Block 276 is a decision block that represents the present 

puter 108. Block 252 represents the remote computer 108 invenUon determining whether the file is a AckRequestFile 

scanning a work directory for any new files or files where or request for additional files request. If the message is an 

date/time and/or size have changed. AckRequestFile, control proceeds to block 278. Otherwise, 

Block 254 is a decision block that represents the present 45 control returns to block 270. 

invention determining if a new file exists. If so, the present Block 278 represents the present invention locating the 

invention proceeds to block 256. Otherwise, the present original package as specified in the e-mail message. For 

invention proceeds to block 262. example, FIG, 3D shows an exemplary original package. 

Block 256 is a decision block that represents the present The package name 350 is snapsbot.pkg and the message type 

invention determining if the new file is a sub package or a 5Q 352 is Normal. 

Normal package. If the file is a sub-package, it's name and Bbck 2g 0 represents the present invention extracting the 

location is added to a construction list, as represented by nec mes from the ori inal snapshol package and 

block 258. This construction hst is used for tracking sub- cr 0 f sub-packages that contain the file images 

packages as they arrive to the remote computer 108. The . . .« . r * r *u ™ 1 

backed sub-packages may be built into a Normal package. 10 * sen 5^™™^ h T * 7 h T 

Otherwise, if the file is not a sub-package, then it is a NonSal * "V™*** by FKS. 3D Uic total mu^ber of requested files 

package file and control proceeds to block 260. 358 15 three >. 35 Crated by filel 360, file2 362 and file3 

Block 260 represents the present invention reading the 364 > r es P ec trvely. 
Normal package's schedule and determining when to Block 282 represents the present mvention storing a series 
execute the next snapshot package. of compressed file images (sub-packages) as pending out- 
Block 262 is a decision block that represents the present 60 g° in S c ' mail messages. Periodically, the source computer 
invention checking the remote computer 108's construction scans it's database for outgoing messages and sends them 
list(s) for sub-packages that are ready to be merged together via e-mail to the remote computer 108 for processing. The 
to form a Normal package file. If all sub -packages are ready, pending outgoing messages are sent to the remote computer 
then control proceeds to block 264. Otherwise, control 108 in an efficient manner that minimizes the amount of data 
proceeds to block 266. 65 going through the e-mail system. Several methods are used 
Block 264 represents the present invention building the to reduce the amount of data flowing through the e-mail 
original Normal snapshot file package. All sub-packages are system. 
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The first method involves analyzing the database table of FIG. 3B. illustrates an exemplary snapshot description file 

pending outgoing e-mail messages at the source computer 310. The description file contains only the File Header 300, 

104. The outgoing messages that contain the same file pne Image List 304 and Script object/snapshot definition 

attachments are grouped together into a single e-mail mes- 306 me snapshot description file has been created, it 

sages with multiple recipients. This grouping allows the s fa scnt to ^ rcmotc computcrs 108 via e-mail, 
e-mail system to send one file attachment to many recipients 

and move smaller amounts of information through the FIG. 3C displays the format of the e-mail message. In this 

network and corporate infrastructure. diagram, the subject text 312 contains a unique lag "MBA 

A second method for reducing network traffic involves 2.0" which is the key identifier that the present invention 

sending information to the remote computers during a 10 will look for when trying to find incoming mail messages at 

specified time interval. For example, if the remote computer ^ compuler ih al are destined for the remote com- 

108's request for additional files causes the source computer and not the remote user ^ text of tae c . mail m 

104 to generate ten separate compressed images for transfer * A . . n . . , , -j • * 

via e-mail, the source computer 104 may specify that only 314 15 ^ customizable by the user and provides informa- 

the first message of the ten be sent to the remote computer Uon to remote **** m case read lhe messa B e before 

108, and that the remaining nine wait. Once the source 15 toe remote computer 108 agent software can read the 

computer 104 receives an Ack message for the first file message and process it. The remaining information in the 

image, it will then release the second file image to the remote e-mail message, 316 through 328, respectively, specifies the 

computer 108. This process continues until all ten file details about the package being sent. Lastly, the snapshot 

images are successfully sent. If during this process, one of description file attachment 330 is included. The message- 

the files fails to reply with an Ack, the source computer 104 20 lype descr ibes what type of message this e-mail mes- 

will wait until a user defined time-out length has elapsed and sage rqjreS ents. There are several possible types— Normal, 

then it will send out a small test message to the remote Ack ^ AckFileRequest. The Normal message is an outgoing 

computer. This small test message contains the same infor- e . mail message from lhe SO urce computer that contains files 

mation as the Normal e-mail message does except no file {Q be distri5uted t0 a remote mmvVltL Ack messages are 

attachment is included. This is done so that the link between 25 

L .* t\ * » . , mo replies from the remote computer that everything was 

the source computer 104 and the remote computer 108 can . , , , , , ' . 

. . / - . ... t r ,. . received and are processed by the source computer. AckFil- 

be established as successful without re-sending large „ r ,r - , r 

amounts of data. THe test message is acknowledged by the e u Re ^ est me f a * cs are ^ from ^ rc ™ te ^ uic \ 
remote computer 108 with either success (the file image in that the sn ^ oi Ascription file was received but additional 
question did arrive successfully) or failure (the file image in 30 file images are required to continue processing. The package 
question did not arrive). Additionally, the test messages can reference 318 is a unique 128-bit identifier of the package 
also time-out. In this case, subsequent test messages are sent tDat is beirj g and ^ included in the both the Ack and 
until a user specified number of attempts is reached. If the AckFileRequest messages for insuring that the original file 
test message acknowledgment is successful then the source is referenced accurately for additional file images and status 
computer 104 will move on to the next file in the sequence. 35 updates. This is the same i.d. that is used in the file header 
If the test message is a failure, then the source computer 104 (see Table 1, m_id guid). The orig-machine item 320 is a 
will re -send the file image specified since it has been textual name that represents which machine sent the mes- 
determined that the remote computer 108 is available (since sage. The orig-date-local-time 322 and orig-date-gmt-time 
it was able to respond to the test message). 324 are dale/time representations for when the e-mail mes- 
Snapshot Files 4 ° sa S c was SCDl ^ rom trie source computer. The first date/time 
* A m •» i ci r » c field is in local time and the second is in GMT or Universal 
FIGS. 3A-3D illustrate exemplary file formats of a snap- . ™ , G . tU . , , . , 
... . j* * .u * - *• Ume - Th e nexl ne * d 15 tne job-type 326, which denotes 
shot file created according to the present invention. J . ' \ : . , 
T ^ai. * i ci r * * • ... additional information for special distribution jobs and set- 
In FIG. 3A, the snapshot package file format is desenbed. . ;a &~\a ne ™„« m »i.;„i» 
™ „ ' r iL £1 i_ i j • * * tings. The master-i ob-id field 328 is used to group multiple 
The overall structure of the file is broken down into four 45 ^ ' t t t . . .Z , . , 
major sections. The Header 300, located at the top of the file, messa S es that ***** ih * ^me tune with a logical 
is a small fixed-size block of the file. It describes the basics ^ution job as speafied by the user. The file attachment 
of the file format. I^e Header 300 block is described in 330 15 located at * e end of the e " mai1 messa 5 e - 
detail by Table 1. The next major section of the snapshot 

package file is the Compressed File Images section 302. This 50 Conclusion 
is potentially a very large section of the snapshot file since 

the compressed images may total hundreds of megabytes of This concludes the description of the preferred embodi- 

data. The next major section of the snapshot file is the File ment of the invention. The present invention discloses a 

Image List 304. The File Image List is a fist of all the files method, apparatus, and article of manufacture for distribut- 

in the Compressed File Image section 302 and it includes the 55 ing a software application residing on a network 106, from 

file name, size, date/time, version and oflset inside the a source computer 104 coupled to the network 106, to one 

Compressed File Image block. The last major section of the 0 r more remote computers 108 that are not coupled to the 

snapshot package file is the Script object and Snapshot network 106. 
definition 306, This section contains the script object that 

defines what components of the computer (files, configura- 60 ^ foregoing description of the preferred embodiments 

uon settings, Registry entries) should look like and how to of the invention has been presented for the purposes of 

change them. In the preferred embodiment of the present illustration and description. It is not intended to be exhaus- 

invention, both the File Images list 304 and the Script object uVe or to limit the invention to the precise form disclosed, 

and Snapshot definition 306 are kept at the end of the Many modifications and variations are possible in fight of 

snapshot package file so that they can be changed and 65 the above teaching. It is intended that the scope of the 

written back to the snapshot package file without having to invention be limited not by this detailed description, but 

re-write the entire File Images section. rather by the claims appended hereto. 
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Rlc: Headei Format 







Size 




Field Name 


Field Type 


(bytes) 


Description 


m_signature__guid 


GUID 


16 


File format signature, identifies this as snapshot file 








format. 


m_wVersion 


WORD 


2 


File format version (High byte is most significant) 


m_dwFlags 


DWORD 


4 


File format flags 


m_Jd_guid 


GUID 


16 


Unique signature for this specific file 


m_dwFilcSize 


DWORD 


4 


Last known size of whole file 


posFirstFilelm&ge 


SF_PosrnoN 


16 


Position of first file image inside archive. Also 






contains reference to sub- file index if file image stored 








in another file. 


pos Firs tFile List 


SF_posrnoN 


16 


Position of file list in archive, always second to last 






object in the file 


m_posScriptFile 


SF_ POSITION 


16 


Position of script file, always last object in the file. 


m_wSubFile Access Method 


WORD 


2 


Identifies method that file images can be accessed 


m_dwSequence 


DWORD 


4 


Sequence of file images 


m_dwMaxSubFilcSi2e 


DWORD 


4 


Maximum sub file Size 


m_dwLaslSubFile 


DWORD 


4 


Index of last sub file V 


m_szServer 


char 


256 


Path to server name where files are stored 


m_szUserName 


char 


65 


User name to use when connecting to server path 


m_ezPas6word 


char 


65 


Password to use when connecting to server path 


m_sZLo cation 


char 


256 


Location on server for file images 


m_bUseRas 


BOOL 


2 


Rag specifying whether to use Remote Access Server 








(RAS) when connecting to server. 


m bPromptMedia 


BOOL 


2 


Prompt media hag, use this flag to specify that the user 






will be prompted for inserting media before continuing. 








FUe images are contained on that media 


m_szMedin Label 


char 


65 


Text description of media that the user will be 








prompted to insert if m_bPromptMedia is set TRUE 


m_szPkPasswoxd 


char 


33 


Password assigned to package 


m__nScriptSize 


DWORD 


4 


Size of script object (compressed) in file 


m_GroupID 


GUID 


16 


Package file i.d. of parent package if this file is a sub- 








package 


m_wSequence 


WORD 


2 


Sequence of this sub-package 


m_wTotal 


WORD 


2 


Total of sub packages 


m_dlLasRmi 


DATE 


8 


Date/time stamp that this package was last run 


m_wStartLabelID 


WORD 


2 


Starting script object label for execution 


m_Original[D 


GUID 


6 


Original package i.d. that this package was generated 






from (used for sending descriptions of packages) 


m_byOriginaIFilcNainc 


BYTE 


66 


Original package filename 


RESERVED 


DWORD 


14 


Reserved filed for future use 


Structure: SF_POSITION Format 


Size 




Field Name 


Field Type 


(bytes) 


Description 


dwSequeace 


DWORD 


4 


Index of sub file that contains file image at this 






position or zero for the current/main file. 


dwOffset 


DWORDLONG 


8 


Offset of file image inside this file 


RESERVED 


DWORD 


4 


Reserved field for future use 



Flags: PackageFlags Enumerated 
Flag Name 



Value 



Description 



PH_FLAG_READONLY 0x00000001 

PH_FLAG_SUBPACKAGE 0x00000002 

PH_FLAG_PASSWORDREQUIRED 0x00000004 

PH_FLAG_RUNONCEANDDELETE 0x00000008 

PH_FLAG_DELAYFILEMODS 0x00000010 

PH_FLAG_REBOOT 0x00000020 

PH_FLAG_REBOOTALWAYS 0x00000040 

PH_FLAG_ REBOOTPROMPT 0x00000080 

PH_FLAG_REBOOTFORCE 0x00000100 

PH_FLAG_SCRIPTOOMPRESSED 0x00000200 

PH_FLAO_PROFlLEVIEW 0x00000400 

PH_FLAG_REQUESTFILES[FNEEDED 0x00000800 

PH_FLAG_DISTRIBUTED 0x00001000 

PIl_FLAO_SUBFILE 0x00002000 

PH__FLAG_BACKUFFILE 0x00004000 

PH_FLAO_FORCECREATE 0x00008000 

PH_FLAO_SKIPSEMAPHORE 0x00010000 

PH_FLAG_INCLUDESFILEIMAGES 0x00020000 

PH_FLAG_REPLACEOLDERFTLESON T LY 0x00040000 



Package is Read-only 
Package is a sub-package 
Password is required to open 
Execute package once, then delete it 
Delay all the modifications until next 
time the computer restarts 
Reboot the computer after package 
completes 

Always reboot after package completes 

Prompt before rebooting computer 

Force termination of all 

Script object is compressed 

Script object is a profile/snapshot 

Request files as needed 

File images are distributed among sub 

Mies 

This is a sub file 

This is a backup file 

Force creation of file during open 

Skip opening file semaphore 

Include the file images 

Replace older files only on archive 

extract 
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-coatinucd 

PH_FLAG_DLLVERSIONAVAILABLE 0x00080000 DLL File version information Ls 

available with file list information 



25 



What is claimed is: 

1. A method for distributing a software application resid- 
ing on a network from a source computer coupled to the Q 
network to one or more remote computers, comprising the 
steps of: 

at the source computer, identifying one or more software 
installation components, wherein the software installa- 
tion components are used to install the software appli- 
cation; 15 

comparing the identified software installation components 
to each of the remote computer's software installation 
components, wherein the comparison determines 
which of the identified software installation compo- 
nents are absent from each remote computer; 20 

sending the absent software installation components from 
the source computer to each remote computer that lacks 
the absent software installation components; 

maintaining a description of the identified software instal- 
lation components on each remote computer; 

comparing periodically the description of the identified 
software installation components to each remote com- 
puter's software installation components wherein this 
periodic comparison identifies one or mere changes 3(J 
made to each remote computer's software installation 
components and identifies the absent software instal- 
lation components; 

requesting the software installation components absent 
from each remote computer from the source computer; 35 
and 

re -sending the requested software installation components 
absent from each remote computer from the source 
computer to each remote computer, after changes have 
been made to the software installation components of 40 
each remote computer. 

2. The method of claim 1, wherein the sending step 
comprises sending the software installation components via 
an electronic mail system. 

3. The method of claim 1, wherein the sending step 45 
comprises sending the software installation components via 

a modem connected to the network. 

4. The method of claim 3, wherein the identified software 
installation components can be represented as a snapshot or 

a textual list. 50 

5. The method of claim 1, further comprising the step of 
dividing the software installation components into at least 
two packages when the identified software installation com- 
ponents comprise one or more file images. 

6. The method of claim 1, wherein at least one remote 55 
computer is a laptop computer. 

7. The method of claim 1, wherein at least one remote 
computer is a personal digital assistant. 

8. An apparatus for distributing a software application 
residing on a network, from a source computer coupled to 60 
the network, to one or more remote computers that are not 
coupled to the network, comprising: 

(a) a computer; 

(b) means, performed by the computer for identifying one 

or more software installation components that reside on 65 
the source computer, wherein the software installation 
components are used to install the software application; 



(c) means, performed by the computer for comparing the 
identified software installation components to each of 
the remote computer's software installation 
components, wherein the comparison determines 
which of the identified software installation compo- 
nents are absent from each remote computer; 

(d) means, performed by the computer for sending the 
absent software installation components from the 
source computer to each remote computer that lacks the 
absent software installation components; 

(e) means, for maintaining a description of the identified 
software installation components on each remote com- 
puter; 

(f) means, performed by each remote computer for com- 
paring periodically the description of the identified 
software installation components to each remote com- 
puter's software installation components, wherein this 
periodic comparison identifies one or more changes 
made to each remote computer's software installation 
components and identifies the absent software instal- 
lation components; 

(g) means, performed by each remote computer for 
requesting the software installation components absent 
from each remote computer from the source computer; 
and 

(h) means, for re-sending the requested software instal- 
lation components absent from each remote computer 
from the source computer to each remote computer, 
after changes have been made to the software installa- 
tion components of each remote computer. 

9. An article of manufacture comprising a program stor- 
age medium readable by a computer, the medium tangibly 
embodying one or more programs of instructions executable 
by the computer to perform method steps for distributing a 
software application residing on a network, from a source 
computer coupled to the network, to one or more remote 
computers that are not coupled to the network, the method 
comprising the steps of: 

at the source computer, identifying one or more software 
installation components that reside on the source 
computer, wherein the software installation compo- 
nents are used to install the software application; 
comparing the identified software installation components 
to each of the remote computer's software installation 
components, wherein the comparison determines 
which of the identified software installation compo- 
nents are absent from each remote computer; 
sending the identified absent software installation com- 
ponents from the source computer to each remote 
computer that lacks the absent software installation 
components; 

maintaining a description of the identified software instal- 
lation components on each remote computer; 

comparing periodically the description of the identified 
software installation components to each remote com- 
puter's software installation components wherein this 
periodic comparison identifies one or mere changes 
made to each remote computer's software installation 
components and identifies the absent software instal- 
lation components; 
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requesting the software installation components absent computer to each remote computer, after changes have 

from each remote computer from the source computer; been made to the software installation components of 

and each remote computer. 

re -sending the requested software installation components 

absent from each remote computer from the source * + + + + 
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